<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Open a new connection to the MaxDB server</title>
 </head>
 <body class="docs"><div id="layout">
  <div id="layout-content"><div id="function.maxdb-connect" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">maxdb_connect</h1>
  <h1 class="refname">maxdb::__construct</h1>
  <p class="verinfo">(PECL maxdb &gt;= 1.0)</p><p class="refpurpose"><span class="refname">maxdb_connect</span> -- <span class="refname">maxdb::__construct</span> &mdash; <span class="dc-title">Open a new connection to the MaxDB server</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.maxdb-connect-description">
  <h3 class="title">说明</h3>
  <p class="para">过程化风格</p>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>maxdb_connect</strong></span>
    ([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$host</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$passwd</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$dbname</code></span>
   [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$port</code><span class="initializer"> = 0</span></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$socket</code></span>
  ]]]]]] ) : <span class="type">resource</span></div>

  <p class="para rdfs-comment">面向对象风格</p>
  <div class="constructorsynopsis dc-description">
   <span class="methodname"><strong>maxdb::__construct</strong></span>
    ([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$host</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$passwd</code></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$dbname</code></span>
   [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$port</code><span class="initializer"> = 0</span></span>
   [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$socket</code></span>
  ]]]]]] )</div>

  <p class="para rdfs-comment">
   The <span class="function"><strong>maxdb_connect()</strong></span> function attempts to open a connection to the MaxDB Server
   running on <code class="parameter">host</code> which can be either a host name or an IP address. Passing the
   string &quot;localhost&quot; to this parameter, the local host is assumed.
   If successful, the <span class="function"><strong>maxdb_connect()</strong></span>
   will return an resource representing the connection to the database 或者在失败时返回 <strong><code>FALSE</code></strong>.
  </p>
  <p class="para">
   The <code class="parameter">username</code> and <code class="parameter">password</code> parameters specify the
   username and password under which to connect to the MaxDB server. If the password is not provided
   (the <strong><code>NULL</code></strong> value is passed), the MaxDB server will attempt to authenticate the user against
   the <code class="parameter">maxdb.default_pw</code> in <var class="filename">php.ini</var>.
  </p>
  <p class="para">
   The <code class="parameter">dbname</code> parameter if provided will specify the default database to be
   used when performing queries. If not provied, the entry <code class="parameter">maxdb.default_db</code>
   in <var class="filename">php.ini</var> is used.
  </p>
  <p class="para">
   The <code class="parameter">port</code> and <code class="parameter">socket</code> parameters are
   ignored for the MaxDB server.
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.maxdb-connect-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   Returns a resource which represents the connection to a MaxDB Server or
   <strong><code>FALSE</code></strong> if the connection failed.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.maxdb-connect-examples">
  <h3 class="title">范例</h3>
  <div class="example" id="example-1334">
   <p><strong>Example #1 面向对象风格</strong></p>
   <div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$maxdb&nbsp;</span><span style="color: #007700">=&nbsp;new&nbsp;</span><span style="color: #0000BB">maxdb</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"MONA"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"RED"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"DEMODB"</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/*&nbsp;check&nbsp;connection&nbsp;*/<br /></span><span style="color: #007700">if&nbsp;(</span><span style="color: #0000BB">maxdb_connect_errno</span><span style="color: #007700">())&nbsp;{<br />&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Connect&nbsp;failed:&nbsp;%s\n"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">maxdb_connect_error</span><span style="color: #007700">());<br />&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Host&nbsp;information:&nbsp;%s\n"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$maxdb</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">host_info</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/*&nbsp;close&nbsp;connection&nbsp;*/<br /></span><span style="color: #0000BB">$maxdb</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">close</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
  </div>

  </div>
  <div class="example" id="example-1335">
   <p><strong>Example #2 过程化风格</strong></p>
   <div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$link&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">maxdb_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"MONA"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"RED"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"DEMODB"</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/*&nbsp;check&nbsp;connection&nbsp;*/<br /></span><span style="color: #007700">if&nbsp;(!</span><span style="color: #0000BB">$link</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Connect&nbsp;failed:&nbsp;%s\n"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">maxdb_connect_error</span><span style="color: #007700">());<br />&nbsp;&nbsp;&nbsp;exit();<br />}<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Host&nbsp;information:&nbsp;%s\n"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">maxdb_get_host_info</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/*&nbsp;close&nbsp;connection&nbsp;*/<br /></span><span style="color: #0000BB">maxdb_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
   </div>

  </div>
  <p class="para">以上例程的输出类似于：</p>
  <div class="example-contents screen">
<div class="cdata"><pre>
Host information: localhost
</pre></div>
  </div>
 </div>


</div></div></div></body></html>